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INTRODUCTION 

Data General Corporation's Debug II is a program that interfaces with user 
routines as an aid in debugging. It provides for four active breakpoints 
within the user's routines. The accumulators. Carry and memory locations 
can be examined and modified from the teletypewriter after a breakpoint has 
occurred. 

The machine state can be monitored during execution of a routine using sim- 
ple commands to Debug II from the teletypewriter, Debug II interfaces with 
any type of routine, including those that use the DGC interrupt structure. | 



In addition, Debug II can be used to punch ranges of memory in binary format 
acceptable as Input to the Binary Loader and to perform desk-calculator 
type expression evaluations as the teletypewriter. 
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FORMAT OF COMMANDS 

Commands to Debug II are of the general form; 



r 1: _.. ; ,,^ .,..-! _,. 



where: argument is null, a single digit, an address or an expression, 
command is a smalr ~; letype * i& code. 

Argument expressions are of the form: 



octal no. + octal no.* 



where "+" causes octal addition and "-" causes octal subtraction. An octal number 
may be replaced by $» a special symbol meaning "current contents of the most 
recently opened register". 

In the text following, a carriage return will be indicated by the symbol J and a line 
feed will be indicated by the symbol + , 

EXAMINING AND MODIFYING SPECIAL REGISTERS 

Users can examine and modify registers, where "registers" denote both memory 
locations, accumulators, Carry and certain Debug Z r jgisters. 

A register is said to be "open" after it has been examined. The options are either 
to simply "close" the register or to alter the current contents of the open register 
by typing new octal contents before closing it, 

Accumulator Commands 

Accumulators can be examined by the command: 



where n specifies the accumulator (0-3), 
followed by the octal contents of the accun 
may be modified by typing an octal expres 



-nds by typing a slash 
ccumulator is now open and 
closed without alteration. 



A j closes the open register* To modify the contents, type the new octal contents 
followed by ) . 



"Teletype is a registered trademark ol 



t>; rporation, Skokie, Illinois, 
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Accumulator Commands (Continued) 
For example: 



0A/ 000012 ) 

2A/ 000c:: v-.^l/ j 



The command: 



A 



J 



User opens AC0. Debug II prints the current 

contents (000012), and user closes the 

register, 

Imm opens VC2. Demig =1 points the current 

mmerts ((400017), \: <er mcdrmm the contents 

to 000012 and closes the accumulator. 



causes the contents of all four accumulators to be printed out. However, the nA 
command must be given if the user wishes to modify the contents of an accumulator* 

(■':\. - >m v" ~. .;■.• :w :.."'■ :: : " - 

Debug II permit -. cm examination and modification of a number of other special 
registers: 

The command: 



causes the opening and printing of the contents of the Carry register* If Carry was 
set when Debug II was entered* the contents are 000001; otherwise, the contents 

are zeroed. 

The command: 



causes the opening and the printing of the contents of the Interrupt Enable register, 
Bit 15 will be set if interrupts were enabled when Debug II was entered because of 
.: b.'V.-;':ro : pt; other.', i -v, hiv 15 is re mt. 

The- eotmmmJ: 
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Other Special Register Commands (Continued) 

causes the opening and printing of the contents of the "" T - i register. Bits 
14 and 15 are significant, If br. .-' .. --:-. the respective " - flip-flop 

is set. If bit 15 is set, the re spec -. ' * T ic flip-flop is set. The remainder 

of register bits will be zero. 



The command: 



H 



causes the opening and printing of the contents of the Pun ' rice Register, 

register is discussed in the section on punch commands. 



The 



The command: 



L 



causes the opening and printing of the contents of the Starting Location register. 
The register is discussed in the section on run commands* 

The commands: 



and 



M 



cause the opening and printing of the contents of the Word and Mask registers 
respectively. These registers are discussed in the section on search commands. 

The command: 



causes the opening and printing of the contents of Breakpoint Court register n 
(n = 0, 1, 2, or 3). The command is discussed in the section on run commands, 
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-\.i>tl »„;vCl 



'FR: 



on can be opened and examined by tvpim 



adr/ 



where; adr is the octal address of the desired location, 
or M $" for the contents of the current location, 
or ,f . " for the address of the most recently opened memory register, 

Memory locations are modified in the same manner as are special registers, 
by typing the desired octal expression following the printout of the current 
contents, 

A memory register is closed by typing ), In addition to simply closing the 
modified or user can close the current register and 

open the succeeding register by striking a line feed { I ), or he can close the 
current register and open the preceding register by sf "drr - ' y. A N keys). 

A memory location can be opened without its current contents being printed 
by the command; 



adr I 



Location adr is now open for modification. 

When succeeding or preceding locations are opened, using i or t » the contents 
will be printed only if the original command was; 



adr/ 



If the original command was: 



adr] 
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EXAMINING AND MODIFYING MEMORY 



med) 



the contents of the adjacent location heir.;-; ' ,:-'-"■-•-' "*'__" r '~»t be printed, 



PP1P61/ $!'• )0P ) 
, ! 100000 j 



• no modification, 

-open previously closed memory register 
(1061) to alter contents. 



001271/ 017550* 
001272/ 016635 * 
001273/016331 006331 j 



-User opens 1271 and two succeeding 
registers, changing the contents of 
register 1273. 



000766! 017600 t 
000765! 100000 ) 



— User opens without examining registers 
766 snd 765 and changes the contents of 
both. 



$/ 016635) 



*-User examines contents of current 
register. 



MEMORY SEARCH COMMANDS 



The search command is used to search ail memory or portions of memory for 
given contents. The format of the memory search command is: 



[adr x ] [, adr 2 ] S 



where: adr is the optional octal address of the first location to be searched* 
if both arguments are given, 

adr is the optional octal address of the last location to be searched. 

When the command S is given without arguments, the search begins at location 
and terminates at 77777. If only a single address is given, the search starts 
at location 0, and terminates at the address given by the argument. 

The contents axe searched for a match with contents of the W (word) and M (mask) 
registers. The W register contains the contents to be searched for* The mask 
register contains a mask that is ANDed with the location's contents such that a 
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match occurs if: 

w - ; ^£> v 

where { ) means "contents of". 



"s are opened by giving the commands: 



W 



and 



M 



The response from Z.-s~z: z '" 5 .~ ':* » same as for an accumulator. Z^r r '1 - -1" 
print a slash followed by the current octal contents of the re ;"" -.-■'.-. ""- ~ user 
may then change the contents if desired. 



M Z000000 J 
W /010000 ) 



— mask register contains 

— word register is set to 

— user obtains printout of all locations 
from 40 through 710. 



M /000000 174000 ) 
W /0000P0 010000 ) 
S 



-set M to 174000 

-set W to 010000 

-search all of core for all 1SZ instructions 



M : ^'4U 177777 

W /010P00 132765 
777S 



-set M to 177777 (all ones) 

—set W register to word desired 
^search from location through location 
777 for 132675. Debug r -" -utput to the 
consol ' "jcations that match 132675» 
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MANDS 



elements or 
nrorram am 



to execute a 
. breakpoint 
ion, reenter 
:ate of his 



The command to set a breakpoint lias the format; 



adrB 



where: adr is the octal location at which the breakpoint will be set. 

Debug II assigns the address to one of the four breakpoints (numbered to 3), 
unless all breakpoints are active. If all breakpoints are in use, Debug II prints 
out: 



To determine what breakpoints are in use and their addresses, the command: 



B 



is given. Debug II responds by typing the breakpoint number and the location at 
which the breakpoint is set. 

To deactivate all breakpoints, the command: 



D 



can be given. To deactivate a single breakpoint, the command: 



nD 



is given, where n is the number of the breakpoint (0 through 3 ). 

When the user transfers from the debugger to his program for execution (see next 
section. Run Commands), the program will execute until an instruction at which a 
breakpoint is set is encountered. Execution halts before the breakpoint instruction 
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BREAKPOINT COMMANDS (Continued) 

is executed, and control transfers to Debug IL Debug II prints out: 

adrBn 
on the Teletype, where: 

adr is the breakpoint address and 
n is the breakpoint number. 

Debug II then prints the contents of all accumulators. The user can examine further 
the current machine state using any of the Deby_ Z -.ommands. 

If the user examines the breakpoint address he will find the proper contents of his 
program, since Debug II replaces the active breakpoint upon debugger entry with the 
original contents of the address, leaving the breakpoints invisible to the user. 
However, if the user routine .---■. - -C ; " . transfers wildly, the breakpoints 
can be seen by examining the addresses from the control console. 

The breakpoint will appear as the instruction: 



m 



where: n is the number of the breakpoint; Debug II uses locations 10 through hS -if 
page to store address entry points to itself. 

Caution should be used in the placement of breakpoints. r " 2- arbitrarily complex 
subroutine could be transferred to at the breakpoint, the user should have no difficulty 
(since this is what actually happens). The following restrictions should, however, 
be noted: 

1, The breakpoint should never be placed at a data word (since these words 
are never executed. ) 

2, The breakpoint should never be placed at an instruction that is modified 
during execution. 

3, If the Teletype busy flags are set upon breakpoint entry. Debug II will 
wait until they have been cleared before taking control, If TTI Busy 

is set and a tape is not mounted in the reader or a key is not depressed, 
Debug II will loop continuously, 

4, The breakpoint should not be placed at a point where interrupts cannot 
be held off for a long period of time, since Debug II executes an INTDS 
upon entry. 
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5. The breakpoint should not be placed in an interrupt routine after an 
INTEN instruction, since another interrupt may occur and destroy 
location before Debug II gains control, 

6. The breakpoint cannot be placed on any instruction that enables or 
disables interrupts, i.e., INTDS. 

Examples of setting and using breakpoints are included in the next section, Run 
Commands, 

RUN COMMANDS 

Ths user can transfer control from Debug II to the user routine with the command: 



[adr] R 



where: adr is an optional location to which control is transferred. 

If adr is not specified, Debug II will transfer to an address which the user must 
initialize in the starting location register. This register is opened for modification 
by the command: 



To return control to the user routine after a breakpoint, the user can give the 
command: 



[n]P 



where: n is an unsigned integer indicating the number of times the break- 
point instruction is to be encountered before another break occurs 
returning control to Debug II, 

If n is not given, a trap will occur the first time the breakpoint is encountered. 

Note that the count for the P (or Proceed) command applies only to the breakpoint 
that causes transfer to Debug IL it is possible to set the break proceed counts for 
the other breakpoints using the breakpoint count registers. There are four break- 
point count registers, opened using the command: 
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RUN COMMANDS (Continued) 



nN 



where: n is the number (0 through 3) of the breakpoint, 

The contents of each breakpoint count register indicate the number of times the 
instruction having that breakpoint can be executed before a transfer to Debug II 
occurs. The user can. set or modify the proceed count for any breakpoint except 
the one he intends to proceed from. The argument to the P command unconditionally 

overwrites any count in the count register for that breakpoint, 



«7B 

' mww ) 



user sets breakpoint at 1577 and checks 
contents of L register, starting execution 
at that address. 



001557 B3 

000100 000040 000011 000017 

001230 / 015731 ♦ 
001231/ 004020 004fc?~ 



-Debug II prints out breakpoint and contents 
of accumulators at the break, 

-user examines locations 1230 and 1231, 
changing contents of 1231, 



■ 3D 



• user deletes breakpoint 3 but proceeds 
with execution from the instruction that 
contained that breakpoint, 



3134 B2 

000241 001115 000777 000025 

IN 000020/ 1 ) 
15P 



-Control is returned to Debug II at another 
breakpoint, 

•User changes the break proceed counter for 
breakpoint 1, and proceeds with execution 
from breakpoint 2, allowing 14 passes 
through breakpoint 2. 



P UNCH COMMANDS 

Debug 11 allows the user to punch binary tapes of ranges of memory. In this mode 
it performs a function identical to the Binary Punch Program (document 093-000001), 
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FVN'C-I COMMANDS (Continued) 

The user selects the output device to be used for punching by setting the contents 
of the punch device register. The punch device register is opened for examination 
and modification by the command: 



H 



If the output device is to be the Teletype punch, the register should be set to 0; if 
the output device is to be the high speed punch, the register should be set to 1, ~c 
punch blank leader or trailer tape on the output device, the user gives the command; 



nF 



where: n is the number of inches (in octal) of leader to be punched. 
The command determining the range of memory to be punched is: 



adr , adr P 



where: adr is the first location to be punched and 
adr is the last location to be punched . 

adr must be less than or equal to adr . 
An End Block (also called a Start Block) can be punched using the command: 



[adrjE 



where: the optional argument adr is the address to which the Binary Loader will 
transfer control after reading the block. 

If no adr is given, the Binary Loader will halt after reading the block and 
the user can manually insert the starting address, 

A problem arises when using Debug II in punch mode with the Teletype as the output 
device. Since the Teletype is used both for command input and for output, if the 
punch is left in the *'ON" position while typing Debug 11 commands, these characters 
will be punched as part of the output. 
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'.SCli COMMANDS (Continued" 



;bug II resolv 

/p>n. Tip hi 10* Tl 



biem in the following way. After the punch command is 



EXPRESSION EVALUATION 

Debug 11 can be used to perform simple desk calculator operations by using the 
special command; 



expression= 



where: expression follows the format for argument expressions; 

octal no, + octal no, + . . • 

and octal numbers may be replaced by either the special character 
$ (contents of the current location) or the special character . (most 
recently closed location.) 

Debug II will respond with the result of evaluation in octal immediately following 
the = sign. 



561 -472+3 - 5 = 65 

.= P07567 
.+$ =007777 



-if 7567 was the address of the most recently 

closed memory register 
-if 7567 was the address of the most recently 

closed memory register and if the contents 

of the most recently closed register (not 

necessarily memory) were 210. 
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OPERATING PROCEDURE 

There are two absolute binary tapes of Debug II provided as part of the standard 

software package. Debug II is loaded using the Binary Loader, following standard 
loading procedure (See Binary Loader manual, 093-000003, ) 

One binary tape will load into locations 400 to 1777; the other loads into locations 
6200 to 7577, Debug II also requires locations 10 to 13 of page zero. 

A relocatable binary tape of Debug II is provided to users who wish to use 
relocatable loading of Debug II, The starting address specified on the relocatable 
binary tape Is 264 + start of module. Thus, the programmer must check the 
loaded address in his listing and modify as required. 

If control is lost during the testing process, Debug II can be restarted at the start- 
ing location of the particular version being used (400 or 6200), Restarting will 
cause the contents of the accumulators to be printed and the I (Interrupt Enable) 
and T (TTY Done) registers to be cleared. All other Debug II registers and the 
breakpoint locations will remain unchanged. 
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Spec ia 1 Register C omma nds 

A Print the contents of all accumulators. 

nA Open and print the contents of accumulator n, (n = - 3) 

C Open and print contents of Carry register, (Carry set = 1 

H Open and print contents of the Punch Device register. (T 



ITY Done register, (If bit 14 is set, TTI done; if bit 15 set, TTO done J 



•egister, 


(If bit 


C ■■, 


i set 


, TTI i 


3one; 


;er, {See 


Search 


UgT 


nory 


- Comn 


a and: 



M Open and print contents 

nN Open and print contents 

T Open and print contents 

W Open and print contents 

1 Close an open special register. 

Memory Registe r J^ gmmagjis 

adr/ Open and print contents of memory location adr. 

adrl Open memory location adr. 

) Close an open memory register, 

I Close an open memory register and open the succeeding register, 

t Close an open memory register and open the preceding register, 

Search Memory Commands 

n, mS Search contents of memory from address n to address m Inclusive, matching contents of the 
~ ~ location ANDed with contents of the Mask register to the contents of the Word register. 

Bre akgoijit_Cjommands 

B Print out all breakpoiHts and their contents. 

adrB Set a breakpoint at location adr of the user program, 

D Delete ail breakpoints, 

eD Delete breakpoint n. (n = - 3). 

ExecuteyCommancIs 

R Execute user program from location given in the Starting Location register, 

adrR Execute user program from location adr. 

[n]P Proceed with execution of the user program from the instruction containing the last breakpoint. 

Execution will halt when the breakpoint is again encountered unless the integer argument n is 
given, indicating the number of times the breakpoint may be encountered before execution halts. 

Punch Commands 



expression exg and print the resultant octal value. 



-14- 



Changes from Revision 2 to Revision 3 of 093-000020, Debug II User's Manual 

Page Nature of Change 

i NOVA has been changed to DGC. 

5, 10 Addresses in the memory register examples are printed 

out in full before printing contents, 

6 The result of the memory search in the example will cause 

a console printout of any matches found. 

13 The required procedure for using the binary relocatable tape 

of Debug II is included. 
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